home *** CD-ROM | disk | FTP | other *** search
/ PCGUIA 114 / PC Guia 114.iso / Software / Utils / The Gimp 2.2.1 / gimp-help-2-0.6-setup.exe / {app} / share / gimp / 2.0 / help / en / ch01s04.html < prev    next >
Encoding:
Extensible Markup Language  |  2004-12-19  |  10.2 KB  |  246 lines
  1. <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4.   <head>
  5.     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  6.     <title>4.┬áReporting Bugs and Requesting Enhancements</title>
  7.     <link rel="stylesheet" href="gimp-help-plain.css" type="text/css" />
  8.     <link rel="stylesheet" href="gimp-help-screen.css" type="text/css" />
  9.     <meta name="generator" content="DocBook XSL Stylesheets V1.66.1" />
  10.     <link rel="start" href="index.html" title="GIMP User Manual" />
  11.     <link rel="up" href="ch01.html" title="Chapter┬á1.┬áIntroduction" />
  12.     <link rel="prev" href="ch01s03.html" title="3.┬áGimp History" />
  13.     <link rel="next" href="ch01s04s02.html" title="4.2.┬áReporting the Bug" />
  14.   </head>
  15.   <body>
  16.     <div xmlns="" class="navheader">
  17.       <table width="100%" summary="Navigation header">
  18.         <tr>
  19.           <th colspan="3" align="center" id="chaptername">Chapter┬á1.┬áIntroduction</th>
  20.         </tr>
  21.         <tr>
  22.           <td width="20%" align="left"><a accesskey="p" href="ch01s03.html">Prev</a>┬á</td>
  23.           <th width="60%" align="center" id="sectionname">4.┬áReporting Bugs and Requesting Enhancements</th>
  24.           <td width="20%" align="right">┬á<a accesskey="n" href="ch01s04s02.html">Next</a></td>
  25.         </tr>
  26.       </table>
  27.       <hr />
  28.     </div>
  29.     <div class="sect1" lang="en" xml:lang="en">
  30.       <div class="titlepage">
  31.         <div>
  32.           <div>
  33.             <h2 class="title" style="clear: both"><a id="gimp-introduction-bugs"></a>4.┬áReporting Bugs and Requesting Enhancements</h2>
  34.           </div>
  35.         </div>
  36.       </div>
  37.       <a id="id3416750" class="indexterm"></a>
  38.       <p>
  39.     Sad to say, no version of Gimp has yet been absolutely perfect.
  40.     Even sadder, it is likely that no version ever will be.  In spite
  41.     of all efforts to make everything work, a program as complicated
  42.     as Gimp is bound to screw things up occasionally, or even crash.
  43.   </p>
  44.       <p>
  45.     But the fact that bugs are unavoidable does not mean that they
  46.     should be passively accepted.  If you find a bug in Gimp, the
  47.     developers would like to know about it so they can at least try to
  48.     fix it.
  49.   </p>
  50.       <p>
  51.     Suppose, then, that you have found a bug, or at least think you
  52.     have:  you try to do something, and the results are not what you
  53.     expect.  What should you do?  How should you report it?
  54.   </p>
  55.       <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
  56.         <table border="0" summary="Note">
  57.           <tr>
  58.             <td rowspan="2" align="center" valign="top" width="25">
  59.               <img alt="[Note]" src="../images/note.png" />
  60.             </td>
  61.             <th align="left">Note</th>
  62.           </tr>
  63.           <tr>
  64.             <td colspan="2" align="left" valign="top">
  65.               <p>
  66.       The procedure for making an <span class="emphasis"><em>enhancement
  67.       request</em></span>ΓÇôthat is, for asking the developers to add a
  68.       missing featureΓÇôis nearly the same as the procedure for
  69.       reporting a bug.  The only thing you do differently is to mark the
  70.       report as an "enhancement" at the appropriate stage, as described
  71.       below.  
  72.     </p>
  73.             </td>
  74.           </tr>
  75.         </table>
  76.       </div>
  77.       <p>
  78.     In common with many other free software projects, Gimp uses a
  79.     bug-reporting mechanism called <span class="emphasis"><em>Bugzilla</em></span>.
  80.     This is a very powerful web-based system, capable of managing thousands of
  81.     bug reports without losing track.  In fact, Gimp shares its
  82.     Bugzilla database with the entire Gnome project.  At the time this
  83.     is being written, Gnome Bugzilla contains 148632 bug reportsΓÇôno,
  84.     make that 148633.
  85.   </p>
  86.       <div class="sect2" lang="en" xml:lang="en">
  87.         <div class="titlepage">
  88.           <div>
  89.             <div>
  90.               <h3 class="title"><a id="id3416813"></a>4.1.┬áMaking sure it's a Bug</h3>
  91.             </div>
  92.           </div>
  93.         </div>
  94.         <p>
  95.       The first thing you should do, before reporting a bug, is to make
  96.       an effort to verify that what you are seeing really
  97.       <span class="emphasis"><em>is</em></span> a bug.  It is hard to give a method for
  98.       doing this that applies to all situations, but reading the
  99.       documentation will often be useful, and discussing the question on
  100.       IRC or a mailing list may also be quite helpful.  If you are
  101.       seeing a <span class="emphasis"><em>crash</em></span>, as opposed to mere
  102.       misbehavior, the odds that it is a true bug are pretty high: well
  103.       written software programs are not designed to crash under
  104.       <span class="emphasis"><em>any</em></span> circumstances.  In any case, if you have
  105.       made an conscientious effort to decide whether it is really a bug,
  106.       and at the end still aren't sure, then please go ahead and report
  107.       it:  the worst that can happen is that you will waste a bit of
  108.       time for the development team.
  109.     </p>
  110.         <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
  111.           <table border="0" summary="Note">
  112.             <tr>
  113.               <td rowspan="2" align="center" valign="top" width="25">
  114.                 <img alt="[Note]" src="../images/note.png" />
  115.               </td>
  116.               <th align="left">Note</th>
  117.             </tr>
  118.             <tr>
  119.               <td colspan="2" align="left" valign="top">
  120.                 <p>
  121.         Actually there are a few things that are known to cause Gimp to
  122.         crash but have turned out to be too inconvenient to be worth
  123.         fixing.  One of them is asking Gimp to do something that requires
  124.         vast amounts of memory, such as creating an image one million
  125.         pixels on a side.
  126.       </p>
  127.               </td>
  128.             </tr>
  129.           </table>
  130.         </div>
  131.         <p>
  132.       You should also make sure that you are using an up-to-date version
  133.       of Gimp: reporting bugs that have already been fixed is just a
  134.       waste of everybody's time.  (Gimp 1 is no longer maintained, so if
  135.       you use it and find bugs, either upgrade to Gimp 2 or live with
  136.       them.)  Particularly if you are using the development version of
  137.       Gimp, make sure that you can see the bug in the latest release
  138.       before filing a report.
  139.     </p>
  140.         <p>
  141.       If after due consideration you still think you have a legitimate
  142.       bug report or enhancement request, the next step is to go to
  143.       Gimp's bugzilla query page (http://bugzilla.gnome.org/query.cgi),
  144.       and try to see whether somebody else has already reported the same
  145.       thing.  The query page allows you to search the bug database in a
  146.       variety of ways.  Unfortunately this page is a bit more
  147.       complicated to use than it really ought to be, but here is
  148.       basically what you should do:
  149.     </p>
  150.         <div class="variablelist">
  151.           <dl>
  152.             <dt>
  153.               <span class="term">Summary:</span>
  154.             </dt>
  155.             <dd>
  156.               <p>
  157.             Set this to "contains any of the words/strings".
  158.           </p>
  159.             </dd>
  160.             <dt>
  161.               <span class="term">(the adjoining entry area)</span>
  162.             </dt>
  163.             <dd>
  164.               <p>
  165.             Give one or more words that somebody would be likely to use in
  166.             writing a one-sentence summary of a bug similar to yours.  For
  167.             example, if the problem is that zooming too much causes Gimp
  168.             to crash, the word "zoom" would be good.
  169.           </p>
  170.             </dd>
  171.             <dt>
  172.               <span class="term">Product:</span>
  173.             </dt>
  174.             <dd>
  175.               <p>
  176.             Set this to "GIMP"
  177.           </p>
  178.             </dd>
  179.             <dt>
  180.               <span class="term">Component:, Version:, Target:</span>
  181.             </dt>
  182.             <dd>
  183.               <p>
  184.             Don't do anything for these.
  185.           </p>
  186.             </dd>
  187.             <dt>
  188.               <span class="term">Text information:</span>
  189.             </dt>
  190.             <dd>
  191.               <p>
  192.             For now, leave this alone.  If your search does not turn up
  193.             anything, it might be worth entering your search terms in the
  194.             "comment" area here, but this often turns out to give you
  195.             either great masses of stuff or nothing.
  196.           </p>
  197.             </dd>
  198.             <dt>
  199.               <span class="term">Status:</span>
  200.             </dt>
  201.             <dd>
  202.               <p>
  203.             This field encodes the status of a bug report: whether it is
  204.             still open, has been resolved, etc.  You want to see all
  205.             relevant bug reports, regardless of status, so you should hold
  206.             down the mouse and sweep it across all entries.  Leaving it
  207.             alone will not work.
  208.           </p>
  209.             </dd>
  210.           </dl>
  211.         </div>
  212.         <p>
  213.       When you have set these things up, click on the "Search" button at
  214.       either the top or bottom; they both do the same thing.  The result
  215.       is either a list of bug reportsΓÇôhopefully not too longΓÇôor a
  216.       message saying "Zarro boogs found".  If you don't find a related
  217.       bug report by doing this, it may be worth trying another search
  218.       with different terms.  If in spite of your best efforts, you file
  219.       a bug report and it ends up being resolved as "Duplicate", don't
  220.       be too upset:  it has happened repeatedly to the author of this
  221.       documentation, who works with Gimp Bugzilla nearly every day.
  222.     </p>
  223.       </div>
  224.     </div>
  225.     <div class="navfooter">
  226.       <hr />
  227.       <table width="100%" summary="Navigation footer">
  228.         <tr>
  229.           <td width="40%" align="left"><a accesskey="p" href="ch01s03.html">Prev</a>┬á</td>
  230.           <td width="20%" align="center">
  231.             <a accesskey="u" href="ch01.html">Up</a>
  232.           </td>
  233.           <td width="40%" align="right">┬á<a accesskey="n" href="ch01s04s02.html">Next</a></td>
  234.         </tr>
  235.         <tr>
  236.           <td width="40%" align="left" valign="top">3.┬áGimp History┬á</td>
  237.           <td width="20%" align="center">
  238.             <a accesskey="h" href="index.html">Home</a>
  239.           </td>
  240.           <td width="40%" align="right" valign="top">┬á4.2.┬áReporting the Bug</td>
  241.         </tr>
  242.       </table>
  243.     </div>
  244.   </body>
  245. </html>
  246.